Einrichten einer Django-Entwicklungsumgebung

Django macht es sehr einfach, Ihren eigenen Computer so einzurichten, dass Sie mit der Entwicklung von Webanwendungen beginnen können. Dieser Abschnitt erklärt, was Sie mit der Entwicklungsumgebung erhalten, und bietet einen Überblick über einige Ihrer Einrichtungs- und Konfigurationsmöglichkeiten. Der Rest des Artikels erklärt die empfohlene Methode zur Installation der Django-Entwicklungsumgebung auf Ubuntu, macOS und Windows und wie Sie sie testen können.

Die Entwicklungsumgebung ist eine Installation von Django auf Ihrem lokalen Computer, die Sie zum Entwickeln und Testen von Django-Anwendungen verwenden können, bevor Sie sie in einer Produktionsumgebung bereitstellen.

Die Hauptwerkzeuge, die Django selbst bereitstellt, sind eine Reihe von Python-Skripten zum Erstellen und Arbeiten mit Django-Projekten zusammen mit einem einfachen Entwicklungs-Webserver, den Sie verwenden können, um lokale (d.h. auf Ihrem Computer, nicht auf einem externen Webserver) Django-Webanwendungen in Ihrem Webbrowser zu testen.

Es gibt andere periphere Tools, die oft Teil der Entwicklungsumgebung sind, die wir hier nicht behandeln werden. Dazu gehören Dinge wie ein Texteditor oder eine IDE zum Bearbeiten von Code, Linters für die automatische Formatierung und so weiter. Wir gehen davon aus, dass Sie bereits einen Texteditor installiert haben.

Django ist extrem flexibel in Bezug darauf, wie und wo es installiert und konfiguriert werden kann. Django kann:

• Auf verschiedenen Betriebssystemen installiert werden.
• Aus dem Quellcode, aus dem Python Package Index (PyPi) und in vielen Fällen aus der Paketmanager-Anwendung des Host-Computers installiert werden.
• So konfiguriert werden, dass eine von mehreren Datenbanken verwendet wird, die möglicherweise ebenfalls separat installiert und konfiguriert werden müssen.
• In der Hauptsystem-Python-Umgebung oder innerhalb separater Python-virtuellen Umgebungen ausgeführt werden.

Jede dieser Optionen erfordert eine leicht unterschiedliche Konfiguration und Einrichtung. Die folgenden Unterabschnitte erklären einige Ihrer Wahlmöglichkeiten. Für den Rest des Artikels zeigen wir Ihnen, wie Sie Django auf einer kleinen Anzahl von Betriebssystemen einrichten können, und diese Einrichtung wird im Rest dieses Moduls angenommen.

Welche Betriebssysteme werden unterstützt?

Django-Webanwendungen können auf fast jedem Rechner ausgeführt werden, der die Programmiersprache Python 3 ausführen kann: Windows, macOS, Linux/Unix, Solaris, um nur einige zu nennen. Fast jeder Computer sollte die notwendige Leistung haben, um Django während der Entwicklung auszuführen.

In diesem Artikel geben wir Anweisungen für Windows, macOS und Linux/Unix.

Welche Python-Version sollte verwendet werden?

Sie können jede Python-Version verwenden, die von Ihrer Ziel-Django-Veröffentlichung unterstützt wird. Für Django 5.0 sind die erlaubten Versionen Python 3.10 bis 3.12 (siehe FAQ:Installation).

Das Django-Projekt empfiehlt (und "unterstützt offiziell"), die neueste verfügbare Version der unterstützten Python-Veröffentlichung zu verwenden.

Wo können wir Django herunterladen?

Es gibt drei Orte, um Django herunterzuladen:

• Das Python-Paket-Repository (PyPi) mit dem Tool pip. Dies ist der beste Weg, um die neueste stabile Version von Django zu erhalten.
• Verwenden Sie eine Version aus dem Paketmanager Ihres Computers. Distributionen von Django, die mit Betriebssystemen gebündelt sind, bieten einen vertrauten Installationsmechanismus. Beachten Sie jedoch, dass die verpackte Version ziemlich alt sein kann und nur in der System-Python-Umgebung installiert werden kann (was möglicherweise nicht das ist, was Sie wollen).
• Aus der Quelle installieren. Sie können die neueste aufgeschlossene Version von Django aus dem Quellcode bekommen und installieren. Dies wird Anfängern nicht empfohlen, ist jedoch erforderlich, wenn Sie bereit sind, zum Django-Projekt selbst beizutragen.

Dieser Artikel zeigt, wie man Django aus PyPi installiert, um die neueste stabile Version zu erhalten.

Welche Datenbank?

Django unterstützt offiziell die Datenbanken PostgreSQL, MariaDB, MySQL, Oracle und SQLite, und es gibt Gemeinschaftsbibliotheken, die unterschiedliche Ebenen der Unterstützung für andere beliebte SQL- und NoSQL-Datenbanken bieten. Wir empfehlen, dass Sie sich für Produktion und Entwicklung für dieselbe Datenbank entscheiden (obwohl Django viele Datenbankunterschiede mithilfe seines Objekt-Relationalen Mappers (ORM) abstrahiert, gibt es dennoch mögliche Probleme, die besser vermieden werden).

Für diesen Artikel (und die meisten dieses Moduls) verwenden wir die SQLite-Datenbank, die ihre Daten in einer Datei speichert. SQLite ist als leichte Datenbank gedacht und kann kein hohes Maß an Parallelität unterstützen. Es ist jedoch eine ausgezeichnete Wahl für Anwendungen, die hauptsächlich schreibgeschützt sind.

Systemweit oder in einer Python-virtuellen Umgebung installieren?

Wenn Sie Python3 installieren, erhalten Sie eine einzige globale Umgebung, die von allen Python3-Codes geteilt wird. Während Sie in der Umgebung beliebige Python-Pakete installieren können, können Sie immer nur eine bestimmte Version jedes Pakets gleichzeitig installieren.

Wenn Sie Django in der Standard-/globalen Umgebung installieren, können Sie nur eine Django-Version auf dem Computer ausrichten. Dies kann ein Problem sein, wenn Sie neue Websites (mit der neuesten Version von Django) erstellen möchten, während Sie weiterhin Websites pflegen, die auf ältere Versionen angewiesen sind.

Daher führen erfahrene Python-/Django-Entwickler Python-Anwendungen typischerweise in unabhängigen Python-virtuellen Umgebungen aus. Dies ermöglicht mehrere verschiedene Django-Umgebungen auf einem einzigen Computer. Das Django-Entwicklerteam selbst empfiehlt die Verwendung von Python-virtuellen Umgebungen!

Dieses Modul geht davon aus, dass Sie Django in einer virtuellen Umgebung installiert haben, und wir zeigen Ihnen unten, wie das geht.

Um Django verwenden zu können, müssen Sie Python 3 auf Ihrem Betriebssystem haben. Sie benötigen auch das Tool für den Python Package Index — pip3 —, das zum Verwalten (Installieren, Aktualisieren und Entfernen) von Python-Paketen/Bibliotheken verwendet wird, die von Django und Ihren anderen Python-Anwendungen verwendet werden.

Dieser Abschnitt erklärt kurz, wie Sie feststellen können, welche Python-Versionen vorhanden sind, und bei Bedarf neue Versionen installieren, für Ubuntu Linux 20.04, macOS und Windows 10.

Ubuntu Linux 22.04 LTS enthält standardmäßig Python 3.10.12. Sie können dies bestätigen, indem Sie den folgenden Befehl im Bash-Terminal ausführen:

python3 -V
# Output: Python 3.10.12

Das Tool für den Python Package Index (pip3), das Sie zum Installieren von Paketen für Python 3 (einschließlich Django) benötigen, ist jedoch standardmäßig nicht verfügbar. Sie können pip3 im Bash-Terminal mit dem folgenden Befehl installieren:

sudo apt install python3-pip

macOS enthält standardmäßig kein Python 3 (Python 2 ist auf älteren Versionen enthalten). Sie können dies bestätigen, indem Sie den folgenden Befehl im Terminal ausführen:

python3 -V

Dies zeigt entweder die Python-Versionsnummer an, was darauf hinweist, dass Python 3 installiert ist, oder python3: command not found, was darauf hinweist, dass Python 3 nicht gefunden wurde.

Sie können Python 3 (zusammen mit dem pip3-Tool) einfach von python.org installieren:

1. Laden Sie den erforderlichen Installer herunter:

   1. Gehen Sie zu https://www.python.org/downloads/macos/
   2. Laden Sie die stabile Veröffentlichung der neuesten unterstützten Version herunter, die mit Django 5.0 funktioniert. (Zum Zeitpunkt des Schreibens ist dies Python 3.11.8).

2. Suchen Sie die Datei mit dem Finder und doppelklicken Sie auf die Paketdatei. Folgen Sie den Installationsanweisungen.

Sie können nun die erfolgreiche Installation bestätigen, indem Sie erneut python3 -V ausführen und die Python-Versionsnummer überprüfen.

Sie können auch überprüfen, ob pip3 installiert ist, indem Sie die verfügbaren Pakete auflisten:

pip3 list

Windows enthält standardmäßig kein Python, aber Sie können es (zusammen mit dem pip3-Tool) einfach von python.org installieren:

1. Laden Sie den erforderlichen Installer herunter:

   1. Gehen Sie zu https://www.python.org/downloads/windows/
   2. Laden Sie die stabile Veröffentlichung der neuesten unterstützten Version herunter, die mit Django 5.0 funktioniert. (Zum Zeitpunkt des Schreibens ist dies Python 3.11.8).

2. Installieren Sie Python, indem Sie auf die heruntergeladene Datei doppelklicken und den Installationsanweisungen folgen.

3. Stellen Sie sicher, dass Sie das Kästchen mit der Bezeichnung "Add Python to PATH" ankreuzen.

Sie können dann überprüfen, ob Python 3 installiert wurde, indem Sie den folgenden Text in die Eingabeaufforderung eingeben:

py -3 -V

Der Windows-Installer enthält standardmäßig pip3 (den Python-Paketmanager). Sie können installierte Pakete wie gezeigt auflisten:

py -3 -m pip list

Sie werden feststellen, dass wir in den vorherigen Abschnitten unterschiedliche Befehle verwenden, um Python 3 und pip auf verschiedenen Betriebssystemen auszuführen.

Wenn Sie nur Python 3 installiert haben (und nicht Python 2), können die einfachen Befehle python und pip im Allgemeinen verwendet werden, um Python und pip auf jedem Betriebssystem auszuführen. Wenn dies auf Ihrem System erlaubt ist, erhalten Sie eine Versions-3-Zeichenfolge, wenn Sie -V mit den einfachen Befehlen ausführen, wie gezeigt:

python -V
pip -V

Wenn Python 2 installiert ist, sollten Sie zur Verwendung der Version 3 Befehle mit python3 und pip3 unter Linux/macOS und py -3 und py -3 -m pip unter Windows voranstellen:

# Linux/macOS
python3 -V
pip3 -V

# Windows
py -3 -V
py -3 -m pip list

Die folgenden Anweisungen zeigen die plattformspezifischen Befehle, die auf den meisten Systemen funktionieren.

Die Bibliotheken, die wir für die Erstellung unserer virtuellen Umgebungen verwenden, sind virtualenvwrapper (Linux und macOS) und virtualenvwrapper-win (Windows), die beide das Tool virtualenv verwenden. Die Wrapper-Tools schaffen eine konsistente Schnittstelle zur Verwaltung von Schnittstellen auf allen Plattformen.

Einrichtung der virtuellen Umgebung unter Ubuntu

Nachdem Sie Python und pip installiert haben, können Sie virtualenvwrapper (das virtualenv enthält) installieren. Sie können den offiziellen Installationsleitfaden überprüfen oder den folgenden Anweisungen folgen.

Installieren Sie das Tool mit pip3:

sudo pip3 install virtualenvwrapper

Fügen Sie dann die folgenden Zeilen am Ende Ihrer Shell-Startdatei hinzu (dies ist eine versteckte Datei mit dem Namen .bashrc in Ihrem Home-Verzeichnis). Diese legen den Ort fest, an dem die virtuellen Umgebungen gespeichert werden sollen, den Ort Ihrer Entwicklungsprojektverzeichnisse und den Standort des mit diesem Paket installierten Skripts:

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS=' -p /usr/bin/python3 '
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

Laden Sie dann die Startdatei neu, indem Sie den folgenden Befehl im Terminal ausführen:

source ~/.bashrc

An diesem Punkt sollten Sie eine Reihe von Skripten sehen, die wie unten gezeigt ausgeführt werden:

virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/premkproject
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postmkproject
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/preactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/get_env_details

Jetzt können Sie mit dem Befehl mkvirtualenv eine neue virtuelle Umgebung erstellen.

Einrichtung der virtuellen Umgebung unter macOS

Das Einrichten von virtualenvwrapper auf macOS ist fast genauso wie auf Ubuntu (auch hier können Sie den Anweisungen entweder aus dem offiziellen Installationsleitfaden oder den unten stehenden folgen).

Installieren Sie virtualenvwrapper (und das gebündelte virtualenv) mit pip, wie gezeigt.

sudo pip3 install virtualenvwrapper

Fügen Sie dann die folgenden Zeilen am Ende Ihrer Shell-Startdatei hinzu (dies sind die gleichen Zeilen wie für Ubuntu). Wenn Sie die zsh shell verwenden, dann ist die Startdatei eine versteckte Datei mit dem Namen .zshrc in Ihrem Home-Verzeichnis. Wenn Sie die bash shell verwenden, dann wird es eine versteckte Datei mit dem Namen .bash_profile sein. Möglicherweise müssen Sie die Datei erstellen, wenn sie noch nicht existiert.

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/Library/Frameworks/Python.framework/Versions/3.7/bin/python3
export PROJECT_HOME=$HOME/Devel
source /Library/Frameworks/Python.framework/Versions/3.7/bin/virtualenvwrapper.sh

Laden Sie dann die Startdatei neu, indem Sie den folgenden Befehl im Terminal ausführen:

source ~/.bash_profile

Zu diesem Zeitpunkt sollten Sie eine Reihe von Skripten sehen, die ausgeführt werden (die gleichen Skripte wie bei der Ubuntu-Installation). Sie sollten jetzt in der Lage sein, mit dem Befehl mkvirtualenv eine neue virtuelle Umgebung zu erstellen.

cd ~  # Navigieren Sie zu meinem Home-Verzeichnis
ls -la # Auflisten des Inhalts des Verzeichnisses. Sie sollten .bash_profile sehen
nano .bash_profile # Öffnen Sie die Datei im Nano-Texteditor innerhalb des Terminals
# Scrollen Sie zum Ende der Datei und kopieren Sie die oben genannten Zeilen ein
# Verwenden Sie Ctrl+X, um Nano zu verlassen, wählen Sie Y, um die Datei zu speichern.

Einrichtung der virtuellen Umgebung unter Windows

Die Installation von virtualenvwrapper-win ist noch einfacher als die Einrichtung von virtualenvwrapper, da Sie nicht konfigurieren müssen, wo das Tool Informationen zur virtuellen Umgebung speichert (es gibt einen Standardwert). Alles, was Sie tun müssen, ist den folgenden Befehl in der Eingabeaufforderung auszuführen:

py -3 -m pip install virtualenvwrapper-win

Jetzt können Sie mit dem Befehl mkvirtualenv eine neue virtuelle Umgebung erstellen.

Sobald Sie virtualenvwrapper oder virtualenvwrapper-win installiert haben, ist der Umgang mit virtuellen Umgebungen auf allen Plattformen sehr ähnlich.

Jetzt können Sie mit dem Befehl mkvirtualenv eine neue virtuelle Umgebung erstellen. Wenn dieser Befehl ausgeführt wird, sehen Sie, wie die Umgebung eingerichtet wird (was Sie sehen, ist leicht plattformspezifisch). Wenn der Befehl abgeschlossen ist, wird die neue virtuelle Umgebung aktiv sein — Sie können dies sehen, weil der Beginn der Eingabeaufforderung der Name der Umgebung in Klammern sein wird (unten zeigen wir dies für Ubuntu, aber die letzte Zeile ist ähnlich für Windows/macOS).

mkvirtualenv my_django_environment

Sie sollten eine Ausgabe ähnlich der folgenden sehen:

Running virtualenv with interpreter /usr/bin/python3
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/t_env7/bin/get_env_details
(my_django_environment) ubuntu@ubuntu:~$

Jetzt, da Sie sich innerhalb der virtuellen Umgebung befinden, können Sie Django installieren und mit der Entwicklung beginnen.

Es gibt nur ein paar weitere nützliche Befehle, die Sie kennen sollten (es gibt weitere in der Tool-Dokumentation, aber dies sind die, die Sie regelmäßig verwenden werden):

• deactivate — Verlassen der aktuellen Python-virtuellen Umgebung
• workon — Auflisten verfügbarer virtueller Umgebungen
• workon name_of_environment — Aktivieren der angegebenen Python-virtuellen Umgebung
• rmvirtualenv name_of_environment — Entfernen der angegebenen Umgebung.

Sobald Sie eine virtuelle Umgebung erstellt haben und workon aufgerufen haben, um sie zu betreten, können Sie pip3 verwenden, um Django zu installieren.

# Linux/macOS
python3 -m pip install django~=4.2

# Windows
py -3 -m pip install django~=4.2

Sie können testen, ob Django installiert ist, indem Sie den folgenden Befehl ausführen (dies testet nur, ob Python das Django-Modul finden kann):

# Linux/macOS
python3 -m django --version

# Windows
py -3 -m django --version

py -m django --version

Tools zur Quellcodeverwaltung (Source Code Management, SCM) und Versionskontrolle ermöglichen es Ihnen, zuverlässig Versionen Ihres Quellcodes zu speichern und wiederherzustellen, Änderungen auszuprobieren und Code zwischen Ihren Experimenten und "bekannt gutem Code" zu teilen, wenn Sie ihn benötigen.

Es gibt viele verschiedene SCM-Tools, darunter git, Mercurial, Perforce, SVN (Subversion), CVS (Concurrent Versions System) usw., und Cloud-SCM-Hostingquellen wie Bitbucket, GitHub und GitLab. Für diese Anleitung werden wir unseren Code auf GitHub hosten, einem der beliebtesten cloudbasierten Quellcode-Hostingdienste, und das git-Tool verwenden, um unseren Quellcode lokal zu verwalten und bei Bedarf an GitHub zu senden.

Git (und GitHub) verwenden Repositories ("Repos") als oberste "Behälter" zur Speicherung von Code, wobei jedes Repo normalerweise den Quellcode für eine einzelne Anwendung oder ein Modul enthält. Repositories können öffentlich sein, in welchem Fall der Code für alle im Internet sichtbar ist, oder privat, in welchem Fall sie auf die besitzende Organisation oder das Benutzerkonto beschränkt sind.

Alle Arbeiten werden an einem bestimmten "Branch" des Codes in Ihrem Repo durchgeführt. Wenn Sie einige Änderungen an einem Branch sichern möchten, können Sie ein "Commit" erstellen, das alle Änderungen seit Ihrem letzten Commit im aktuellen Branch speichert.

Das Repo wird mit einem Standardbranch namens "main" erstellt. Sie können mit git andere Branches davon abzweigen, die zu Beginn alle Commits des ursprünglichen Branches haben. Sie können Branches getrennt weiterentwickeln, indem Sie Commits hinzufügen, und dann später mit einem "Pull Request" (PR) auf GitHub Änderungen von einem Branch zu einem anderen zusammenführen. Sie können auch git verwenden, um zwischen Branches auf Ihrem lokalen Computer zu wechseln, zum Beispiel um verschiedene Dinge auszuprobieren.

Zusätzlich zu Branches ist es möglich, tags auf jedem Branch zu erstellen und später diesen Branch zu diesem Punkt wiederherzustellen.

Zuerst erstellen wir ein Konto auf GitHub (dies ist kostenlos). Dann erstellen und konfigurieren wir ein Repository namens "django_local_library" zur Speicherung der Local Library-Website, während wir es in der restlichen Anleitung weiterentwickeln.

Die Schritte sind:

1. Besuchen Sie https://github.com/ und erstellen Sie ein Konto.

2. Nachdem Sie sich eingeloggt haben, klicken Sie auf den + Link in der oberen Symbolleiste und wählen Sie Neues Repository.

3. Füllen Sie alle Felder in diesem Formular aus. Während diese nicht verpflichtend sind, werden sie dringend empfohlen.

   • Geben Sie einen Repository-Namen ein: "django_local_library".

   • Geben Sie eine neue Repository-Beschreibung ein: "Local Library-Website in Django geschrieben".

   • Wählen Sie "Öffentlich" für das Repository (Standard).

     Warnung: Dies macht allen Quellcode sichtbar. Denken Sie daran, keine Anmeldeinformationen oder andere sensible Materialien in Ihrem Repo zu speichern, es sei denn, es ist privat.

   • Wählen Sie Python in der Add .gitignore Auswahl-Liste.

   • Wählen Sie Ihre bevorzugte Lizenz in der Add license Auswahl-Liste. MDN verwendet "Creative Commons Zero v1.0 Universal" für dieses Beispiel.

   • Markieren Sie Initialisiere dieses Repository mit einer README.

4. Drücken Sie Repository erstellen.

   Das Repository wird erstellt und enthält nur die Dateien README.txt und .gitignore.

Jetzt, da das Repository ("Repo") auf GitHub erstellt ist, möchten wir es auf unseren lokalen Computer klonen (kopieren):

1. Klicken Sie auf GitHub auf den grünen Code-Button. Wählen Sie im Abschnitt "Clone" die Registerkarte "HTTPS" und kopieren Sie die URL. Wenn Sie den Reponame "django_local_library" verwendet haben, sollte die URL in etwa so aussehen: https://github.com/<your_git_user_id>/django_local_library.git.

2. Installieren Sie git auf Ihrem lokalen Computer (offizieller Git-Download-Leitfaden).

3. Öffnen Sie eine Eingabeaufforderung/Terminal und klonen Sie Ihr Repo mit der oben kopierten URL:

   bash

   git clone https://github.com/<your_git_user_id>/django_local_library.git
   

   Dadurch wird das Repository im aktuellen Verzeichnis erstellt.

4. Navigieren Sie in den Ordner des Repos.

   bash

   cd django_local_library
   

Jetzt werden wir die .gitignore-Datei auf dem lokalen Computer ändern, die Änderung committen und das Repository auf GitHub aktualisieren. Dies ist eine nützliche Änderung, aber hauptsächlich machen wir sie, um Ihnen zu zeigen, wie man Änderungen von GitHub zieht, lokal Änderungen vornimmt und sie dann auf GitHub pusht.

1. In der Eingabeaufforderung/dem Terminal holen wir zuerst die neueste Version des Quellcodes von GitHub:

   Hinweis: Dieser Schritt ist nicht unbedingt notwendig, da wir gerade den Quellcode geklont haben und wissen, dass er aktuell ist. Im Allgemeinen sollten Sie jedoch Ihre Quellen von GitHub aktualisieren, bevor Sie Änderungen vornehmen.

   bash

   git fetch origin main
   git pull origin main
   

   Der "origin" ist ein remote, der den Speicherort des Repos angibt, in dem sich der Quellcode befindet, und "main" ist der Branch. Sie können überprüfen, ob Ursprung unser Repo auf GitHub ist, indem Sie den Befehl: git remote -v verwenden.

2. Als nächstes checken wir einen neuen Branch aus, um unsere Änderungen zu speichern:

   bash

   git checkout -b update_gitignore
   

   Der checkout-Befehl wird verwendet, um einen Branch auszuwählen, der der aktuelle Branch ist, an dem Sie arbeiten. Das -b-Flag zeigt an, dass wir beabsichtigen, einen neuen Branch mit dem Namen "update_gitignore" zu erstellen, anstatt einen bestehenden Branch mit diesem Namen auszuwählen.

3. Öffnen Sie die .gitignore-Datei, kopieren Sie die folgenden Zeilen ans Ende der Datei und speichern Sie sie dann:

   # Text backup files
   *.bak
   
   # Database
   *.sqlite3
   

   Beachten Sie, dass .gitignore verwendet wird, um Dateien anzugeben, die nicht automatisch von git gesichert werden sollen, wie z. B. temporäre Dateien und andere Build-Artefakte.

4. Verwenden Sie den Befehl add, um alle geänderten Dateien (die nicht von der .gitignore-Datei ignoriert werden) in den "Staging-Bereich" für den aktuellen Branch hinzuzufügen.

   bash

   git add -A
   

5. Verwenden Sie den Befehl status, um zu überprüfen, ob alle Dateien, die Sie committen möchten, korrekt sind (Sie möchten Quellcodedateien hinzufügen, keine Binärdateien, temporäre Dateien usw.). Es sollte ungefähr so aussehen wie die untenstehende Liste.

   bash

   > git status
   On branch main
   Your branch is up-to-date with 'origin/update_gitignore'.
   Changes to be committed:
     (use "git reset HEAD <file>..." to unstage)
   
           modified:   .gitignore
   

6. Wenn Sie zufrieden sind, committen Sie die Dateien in Ihr lokales Repo, indem Sie das -m-Flag verwenden, um eine kurze, aber klare Commit-Nachricht anzugeben. Dies entspricht der Genehmigung der Änderungen und dem offiziellen Hinzufügen zu Ihrem lokalen Repo.

   bash

   git commit -m ".gitignore: add .bak and .sqlite3"
   

7. Zum jetzigen Zeitpunkt wurde das entfernte Repo nicht geändert. Wir können den update_gitignore-Branch in das "origin"-Repo (GitHub) mit dem folgenden Befehl pushen:

   bash

   git push origin update_gitignore
   

8. Gehen Sie zurück zu der Seite auf GitHub, auf der Sie Ihr Repo erstellt haben, und aktualisieren Sie die Seite.

   Ein Banner sollte erscheinen, mit einer Schaltfläche, die Sie drücken können, wenn Sie den gerade hochgeladenen Branch "Vergleichen und pull requesten" möchten. Wählen Sie die Schaltfläche und folgen Sie dann den Anweisungen, um eine Pull-Anfrage zu erstellen und zu mergen.

   

   Nach dem Zusammenführen enthält der "main"-Branch im Repo auf GitHub Ihre Änderungen an .gitignore.

9. Sie können Ihr lokales Repo weiterhin aktualisieren, wenn sich Dateien ändern, indem Sie diesen Modifizieren/Committen/Push-Zyklus verwenden.

Im nächsten Thema verwenden wir dieses Repo, um den Quellcode unserer lokalen Bibliothekswebsite zu speichern.

Erfahrene Python-Entwickler installieren möglicherweise zusätzliche Tools, wie Linters (die helfen, häufige Fehler im Code zu erkennen).

Beachten Sie, dass Sie einen Django-fähigen Linter wie pylint-django verwenden sollten, da einige gängige Python-Linters (wie pylint) fälschlicherweise Fehler in den standardmäßig für Django generierten Dateien melden.

Der obige Test funktioniert, macht aber nicht wirklich Spaß. Ein interessanterer Test ist es, ein Skelettprojekt zu erstellen und es in Aktion zu sehen. Gehen Sie dazu zunächst in Ihrer Eingabeaufforderung/dem Terminal zu dem Ort, an dem Sie Ihre Django-Anwendungen speichern möchten. Erstellen Sie einen Ordner für Ihre Test-Site und navigieren Sie in diesen hinein.

mkdir django_test
cd django_test

Sie können dann eine neue Skelett-Website mit dem Namen "mytestsite" mit dem Tool django-admin erstellen, wie gezeigt. Nachdem Sie die Site erstellt haben, können Sie in den Ordner navigieren, in dem sich das Hauptskript zum Verwalten von Projekten befindet, manage.py genannt.

django-admin startproject mytestsite
cd mytestsite

Wir können den Entwicklungs-Webserver innerhalb dieses Ordners mit manage.py und dem Befehl runserver ausführen, wie gezeigt.

# Linux/macOS
python3 manage.py runserver

# Windows
py -3 manage.py runserver

Sobald der Server läuft, können Sie die Site anzeigen, indem Sie zu der folgenden URL in Ihrem lokalen Webbrowser navigieren: http://127.0.0.1:8000/. Sie sollten eine Seite sehen, die so aussieht:

Sie haben nun eine Django-Entwicklungsumgebung auf Ihrem Computer eingerichtet und in Betrieb.

Im Abschnitt Testen haben Sie auch kurz gesehen, wie wir mit django-admin startproject eine neue Django-Website erstellen und mit dem Entwicklungs-Webserver (python3 manage.py runserver) in Ihrem Browser ausführen können. Im nächsten Artikel erweitern wir diesen Prozess und bauen eine einfache, aber vollständige Webanwendung.

• Schnelle Installationsanleitung (Django-Dokumentation)
• Django installieren — Kompletter Leitfaden (Django-Dokumentation) — behandelt auch das Entfernen von Django
• Django auf Windows installieren (Django-Dokumentation)

• Zurück
• Übersicht: Django Webframework (Python)
• Weiter